home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / ip / manage / snmp / cmu-snmp1.0 / man / snmptest.1 < prev    next >
Encoding:
Text File  |  1989-09-19  |  3.5 KB  |  92 lines
  1. .\* /***********************************************************
  2. .\"     Copyright 1988, 1989 by Carnegie Mellon University
  3. .\" 
  4. .\"                       All Rights Reserved
  5. .\" 
  6. .\" Permission to use, copy, modify, and distribute this software and its 
  7. .\" documentation for any purpose and without fee is hereby granted, 
  8. .\" provided that the above copyright notice appear in all copies and that
  9. .\" both that copyright notice and this permission notice appear in 
  10. .\" supporting documentation, and that the name of CMU not be
  11. .\" used in advertising or publicity pertaining to distribution of the
  12. .\" software without specific, written prior permission.  
  13. .\" 
  14. .\" CMU DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
  15. .\" ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
  16. .\" CMU BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
  17. .\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  18. .\" WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
  19. .\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  20. .\" SOFTWARE.
  21. .\" ******************************************************************/
  22. .TH SNMPTEST 1 "17 September 1989"
  23. .UC 4
  24. .SH NAME
  25. snmptest - communicates with a network entity using SNMP GET Requests.
  26. .SH SYNOPSIS
  27. snmptest host community
  28. .SH DESCRIPTION
  29. Snmptest is a flexible SNMP application that can monitor and manage
  30. information on a network entity.
  31. .PP
  32. The
  33. .I host
  34. specification may be either a host name or an internet address
  35. specified in "dot notation"
  36. .PP
  37. The
  38. .I community
  39. specifies the community name for the transaction with the remote system.
  40. .PP
  41. After invoking the program, a command line
  42. interpreter proceeds to accept commands.  It will prompt with:
  43. .PP
  44. .I Please enter the variable name:
  45. .PP
  46. At this point you can enter one or more variable names, one per line.
  47. A blank line is a command to send a request for each of the variables (in a single
  48. packet) to the remote entity. Each variable name is given in the format specified in
  49. .IR variables (5).
  50. For example
  51. .PP
  52. .I snmpget netdev-kbox.cc.cmu.edu public
  53. .br
  54. .I Please enter the variable name: system.sysdescr.0
  55. .br
  56. .I Please enter the variable name: 
  57. .PP
  58. Will return some information about the request and reply packets, as well as the
  59. information:
  60. .PP
  61. .I Name: system.sysDescr.0
  62. .br
  63. .I OCTET STRING- (ascii):    Kinetics FastPath2
  64. .PP
  65. Upon startup, the program defaults to sending a GET Request packet.  This can be changed
  66. to a GET NEXT Request or a SET Request by typing the commands "$N" or "$S" repectively.  Typing
  67. "$G" will go back to the GET Request mode.
  68. .PP
  69. The command "$D" will toggle the dumping of each sent and received packet.
  70. .PP
  71. When in the "SET Request" mode, more information is requested by the prompt for each variable.  The prompt:
  72. .PP
  73. .I Please enter variable type [i|s|n]: 
  74. .PP
  75. requests the type of the variable be entered.  Type "i" for an integer, "s" for an octet string,
  76. and "n" for a null value.
  77. .br
  78. At this point a value will be prompted for:
  79. .PP
  80. .I Please enter new value: 
  81. .PP
  82. If this is an integer value, just type the integer (in decimal).  If it is a string, type in
  83. white-space seperated decimal numbers, one per byte of the string.  Again type a blank line at
  84. the prompt for the variable name to send the packet.
  85. .PP
  86. At the variable name line, typing "$Q" will quit the program.
  87. .PP
  88. Adding a "-d" to the argument list will cause the application to dump input and output packets.
  89. .PP
  90. .SH "SEE ALSO"
  91. variables(5), RFC 1065, RFC 1066, RFC 1067
  92.